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ABSTRACT 


This  document  provides  a  brief  history,  identifies  the  capabilities,  and 
outlines  execution  procedures  for  terrain  data  display  and  modification 
software  originally  written  for  Tektronix  4027  hardware.  Conversion  to  a 
VAX/Ramtek  environment  and  several  capabilities  enhancements  are  described, 
well  as  procedures  for  executing  the  new  package. 


i  v 
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1.  Background.  In  1979,  CASAA  (now  TRAC-FLYN)  contracted  BDM  Corporation  to 
produce  a  terrain  data  base  for  the  Corps  Battle  Game  (predecessor  to 
CORDIVEM).  Under  the  terms  of  this  contract,  BOM  was  to  produce  digitized 
terrain  data,  LOC  and  hydrography  nets  for  virtually  all  of  Germany.  Shortly 
thereafter  Data  Management  personnel  developed  software  on  a  Tektronix  4027 
terminal  which  utilized  its  graphics  capability  to  allow  display  and 
modification  of  the  data.  There  are  actually  two  software  packages  involving 
graphics  displays.  The  first  package  allows  the  user  to  display,  and  if 
necessary  modify,  the  "features"  (vegetation)  data  (see  paragraph  2a).  The 
second  package  allows  display  of  digitized  road  and  river  data  and  the  display, 
development,  and  modification  of  the  "hex  road  equivalents"  which  were  used  in 
CORDIVEM  and  are  currently  used  in  CORBAN.  In  early  April  1987,  Scientific  and 
Technical  Support  Directorate  (STSD),  Computer  Support  Division  (CSD), 
Technology  Applications  Branch  -  Graphics  Team  (TAB-GT),  was  tasked  to  convert 
this  capability  to  current  hardware  configurations.  -Currently,  TRAC-FLVN's 
primary  graphics  hardware  is  the  Ramtek  9400  series  accessed  through  any  of 
several  VAX  computers  in-house. 

‘  "/ 

2.  Original  capabilities.  The  Tektronix  4027-compatible  Data  Management 
produced  software  allowed  the  user  to  display  and  modify  terrain  data  as 
required.  The  total  package  consists  of  five  subpackages  which  perform  various 
data  manipulation  functions.  Each  subpackage  consists  of  20-35  subroutines 
with  some  overlap.  Conversion  was  required  for  only  the  two  of  these 
sub'ackages  involving  graphics  displays.  Each  of  these  is  described  in  detail 
be'ow  while  the  converted  packages  _rs  described  in  paragraph  3. 

a.  Features  data.  Prior  to  execution  of  this  software  the  user  ha: 
to  do  several  logical  unit  assignments  reouired  during  execution.  Executi  - 
was  reasonably  straightforward  with  the  user  responding  tc  prompts, e.c. : 


Enter  the  coordinates  of  the  $W  corner 
Features? 

Contours? 

Contour  interval?  (if  yes  above) 

<proararr  displays  appropriate  terrain  map  with  color  pa-  lecco 
Corrections  to  features? 

Color?  (i:  yes  above) 

<prograrr  displays  crosshairs  on  the  screen  which  the  user  positions 
by  usi  pc  the  keypad  arrow  keys  and  striking  any  key  to  designate 
vertices  of  a  polygor  representing  the  new  area  to  be  fillec  in  with 
the  selected  color,  to  terminate,  user  must  select  key  C.> 


Another  patch? 


<if  yes,  all  above  steps  are  repeated;  if  no,  the  old  data  file  is 
automatically  overwritten> 


b.  Roads  &  rivers  data.  Prior  to  execution  of  this  software,  the 
user  had  to  do  several  logical  unit  assignments  required  during  execution. 
Execution  was  reasonably  straightforward  with  the  user  responding  to  prompts, 
e.g. : 

Loc  or  hydro? 

Hex  size? 

Roads?  (may  imply  rivers  depending  on  first  response) 

Enter  map  name,  terminate  with  a  period  please 

<program  now  displays  the  selected  area  overlayed  by  the  level  of 
hex  chosen  with  some  hex  sides  in  color  to  represent  the  type  of 
river  flow  between  hexes  (or  with  hex  center  joining  segments  to 
represent  the  area  road  network)  followed  by  the  display  of  tne 
digitized  road  (or  river)  data  and  a  set  of  crosshairs  for  modifying 
the  hex  data.  While  in  this  mode,  the  user  can  “erase"  or  "refresh" 
selected  road  (or  river)  types  by  using  the  4027  function  keys> 

More  changes? 

3.  Converted  software  capabilities.  Top  priority  was  given  tc  assuri-t 
no  loss  of  capability  in  the  conversion  effort.  Certain  modes  of  operatic- 
were  modified  (e.g.  the  removal  of  function-key  usage  to  avoid  future 
compatibility  problems)  but  the  user  remains  able  to  perform  all  function:  ?: 
before,  and  in  several  instances,  more  easily.  In  addition,  a  number  c* 
package  enhancements  were  incorporated  and  are  delineated  ir,  paragraph  L . 

a.  Features  data.  Software  was  consolidated  into  a  single  text 
library  and  corresponding  object  library  under  a  single  cirectory  heading 
(currently  [terrain. surface. display]) .  All  internal  references  were  cnanced  t 
reference  commons  co-located  ir.  a  single  directory  (currently 
[terrain. common]).  The  appropriate  logical  assignments  are  all  a:co~:l *  shed  t 
executing  the  "terrair"  login  file.  Programmer  aocumenteti on  exists  Dcth  ir 
the  converted  routines  and  in  a  separate  file  titled  "Odoc.doc"  locate:  ir.  the 
same  directory  as  the  software.  Tc  execute  the  current  terrair  scftv.a-e,  the 
user  need  only  locate  hi:  self  at  c  terminal  near  a  Ramtek  monitor  anc  c-asnc: 
tablet  (site  is  rot  important  as  7A--GT  has  modifies  tne  application  s:*'lv,:re 
and  the  applicable  graphics  package  (CGI?)  to  be  compatible  with  all  TRAC-FLVN 
hardware  configurations)  and  oo  as  follows: 

ASSIGN  DISK  :  [DIR]  TERDISk  (wr.ere  DISK  :[DlP:j  is  the  disk/directory 

location  of  too  level  terrain  software) 


PTERDISJCLOGIN  (executes  the  above  mentioned  login  file) 

RUNDISP  (does  logical  assignments  S  executes  the  software) 

'2 


la 


RM  : 


(appropriate  Ramtek  logical  for  your  site  -  on  monitor) 
Do  you  wish  to  change  color  values? 

Change  which  color  code? 

<current  RGB  intensities  for  selected  color  are  displayed> 

Enter  new  intensities 
Change  another  color? 

Enter  the  coordinates  of  the  SW  corner  (0,0  to  end) 

Features? 

Contours? 

Contour  interval?  (if  yes  above) 


Enter  coarseness  factor 

< program  displays  appropriate  terrain  map  with  color  bar  legend> 
Corrections  to  features? 

Color?  (if  yes  above) 

Terminate  polygon  definition  by  entering  cursor  position  outside  mat 

<program  "turns  or,"  the  cursor  and  activates  the  graph  tablet  for 
polygon  definition  via  the  graphics  pen/puck> 

Another  patch? 

<if  yes,  ell  of  the  above  steps  are  repeated> 

be  you  wish  to  save  all  new  data  to  file?  (if  no  above) 

Sew  version  of  <oata  file  name>  has  beer,  created  (if  yes  above) 


o.  Roacs  and  rivers  Qcta.  Software  was  consolidated 
to;  l:;rar>  and  do-’-esporairic  object  l-jrary  under  a  single  d 
i  currently  [ terra -• r .  1  ocne>  .hex]) .  All  internal  references  wer 
reference  commons  cc-located  in  a  single  directory  (currently 
[terrair, .common] ; .  ~re  appropriate  logical  assignments  are  all 
executing  the  ''terrair."  login  file.  Programmer  documentation 
the  converted  routines  and  in  a  separate  file  titlec  "0doc.doc 
samp  directory  as  the  software.  To  execute  the  current  terrai 
user  need  only  locate  himself  at  a  terminal  near  a  Ramtek  moni 
tablet  (site  is'  not  important  as  TA6-GT  has  modified  the  appli 
ant  the  applicable  Graphics  package  (CGIP)  to  be  compatible  wi 
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hardware  configurations)  and  do  as  follows: 

ASSIGN  DISK : [0IR3  TERDISK  (where  DISK: [DIR!  is  the  disk/directory 

location  of  top  level  terrain  software) 

@TERDISK:10GIN  (executes  the  above  mentioned  login  file) 

RUNROAD  or  RUNRIVER  (this  does  the  appropriate  logical  assignments  A 

executes  the  software) 

Loc  or  hydro? 

Hex  size? 

Enter  map  name,  terminate  with  a  period  please 

RM _ :  (appropriate  Ramtek  logical  for  your  site  -  on  monitor) 

Do  you  want  hex  autobahns  (or  major  rivers)  displayed? 

Do  you  want  hex  main  roads  (or  rivers)  displayed? 

Do  you  want  hex  secondary  roads  (or  streams)  displayed? 

<program  displays  hex  overlay  for  selected  area  with  hex  roads  (or 
rivers)  as  specified) 

Change  your  display?  (if  yes,  the  three  "do  you  want"  prompts 

repeat.  This  option  allows  the  user  to  "tu-r 
off"  or  “refresh"  only  the  hex  roaas  cr 
rivers  if  desired. ) 

Do  you  want  digitized  roads  (or  rivers)? 

Do  you  want  digitizea  autobahns  (or  major  rivers)  displayed? 

Do  you  want  digitized  main  roads  (or  rivers)  displayed? 

Do  you  want  digitized  secondary  roses  (or  streams)  displayed? 

<prograrr  displays  digitized  roads  (or  rivers)  as  specified) 

Charge  you1'  display?  (if  yes,  same  as  above) 

Er ter  road  (or  river)  tyre  to  draw/cel ete  (use-  selects  tyre  cf  hex 

-oed.'rive-  tc  ir,$-;-t) 

Use  grarr  tablet  to  cc  a:  follows: 

Select  starting  hex  for  -cad  (or  river)’ 

Select  ending  r.ex  for  r:ac 

<prcgrao  crews  appropriate  segment) 

Vore  changes? 

4.  Software  enhancements.  This  section  describes  in  more  detail  eacr  of  the 
enhancements  incorporated  in  the  two  packaces  described  in  paragraph  3.  A 
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comparison  of  paragraphs  2  and  3  will  identify  the  prompt  differences  which 
often  correlate  with  enhancements. 


a.  General .  A  terrain  software  package  specific  login  file  was 
created  to  establish  the  required  symbol  and  logical  assignments  for  compiling 
and/or  executing  the  software.  All  files/routines  specific  to  a  package  reside 
in  the  same  directory;  however,  generic  routines  required  by  multiple  packages 
reside  elsewhere  (these  can  be  determined  most  easily  by  looking  at  the 
appropriate  link  file,  e.g.,  OLINKDISP.COM). 

b.  Features  data.  Numerous  enhancements  to  this  package  were 
incorporated  as  follows: 

RUNDISP  -  A  procedure  file  (ORUNDISP.COM)  was  developed  to  get  the  user 
to  the  appropriate  location  and  execute  the  software. 

Ramtek  logical  -  Enhancements  to  the  CGIP  graphics  package  require 
only  that  the  user  supply  the  four-character  Ramtek  logical  identification  for 
execution  on  any  of  our  hardware  configurations.  These  ID's  can  be  found  on 
a  label  on  the  monitor  selected  (e.g.,  RMAO:). 


Change  color  values  -  This  addition  was  purely  aesthetic.  This 
feature  allows  the  user  to  personalize  color  schemes  for  the  execution 
session.  Since  the  software's  intended  process  is  tedious  and  detailed,  it's 
cuite  easy  to  become  eye  fatigued.  The  user  can  select  any  or  all  colors  and 
roaify  the  intensities  (RGB)  to  his  own  personal  preference. 

Exiting  software  -  Previously  no  provision  for  exiting  existed.  The 
user  was  required  to  interrupt  the  process  by,  for  example,  a  CTRL-Y. 


Coarseness  factor  -  The  software  originally  drew  400  vertical  lines, 
each  representing  a  100-meter  swath  while  varying  the  color  of  the  line  as 
- e cessary  tc  portray  the  variety  of  vegetation  found  in  that  area.  For  better 
C'sr'cv  on  tre  Ramtek  ha-aware,  the  package  was  modified  to  draw  rectangles 
rat.oe-  tn.ar  lines.  Tne  coarseness  factor  then  varies  the  number  of  "vertical’ 
recta':". es  drgwr  to  be  400/c,  where  c  is  the  coarseness  factor.  Tne  time  tc 
craw  tne  map  is  then  reduced  by  the  reciprocal  of  the  coarseness  factor.  (E.g., 
»  i*  tre  user  se'ecis  a  coarseness  factor  of  2,  the  software  will  d-aw  2QC 

l  ’Vertical"  recta:. ties  in  1/2  the  time.) 


not  eta 


■let  usage  -  The  original  software  mace  use  cf  Tektronix  4027 
1  at le  cr.  tne  current  naraware  conficuraticr..  Tne  mocificeti: 


c  *  feat^-es  cats  cr  tne  Tektronix  was  affected  by  moving  crcssr.ai-s  tc  locate 
ea:r.  ve-tex  of  e  tentially  50u-siGec  polygon.  In  tne  new  package,  this  is 
e::cr:  1  ■;  shed  u 


any 


.:  a  grcph  tablet  er.c  puck /per  and  is  terminated  by  the  user 
.potential  vertex,  outside  the  mar  boundaries. 


Optional  save  of  chances  -  The  original  software  automatically  saved 
wnateve-  changes  tne  user  generated  (whether  correct  or  not)  and,  worse, 
overwrote  the  original  data  file.  The  new  package  prompts  the  user  prior  to 
saving  the  data  ar.c  notifies  him  that  a  new  version  of  the  file  has  been 
created  (cleanup  of  obsolete  files  is  then  the  user's  responsibility). 
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c.  Roads  and  river  data.  Several  enhancements  to  this  package  were 
incorporated  as  follows: 

RUNROAD  -  a  procedure  file  (ORUNROAD.COM)  was  developed  to  get  the  user  to 
the  appropriate  location  and  execute  the  software  as  applicable  to  road  network 
development. 

RUNRIVER  -  a  procedure  file  (ORUNRIVER.COM)  was  developed  to  get  the  user 
to  the  appropriate  location  and  execute  the  software  as  applicable  to  river 
network  development. 

Color  labels  -  Color  labels  identifying  the  association  between 
roads/rivers  and  their  corresponding  color  graphics  representation  are  now 
displayed  along  the  left-hand  margin  on  the  monitor.  Previously,  no  link 
between  display  and  representation  existed  (the  user  had  to  be  "software 
smart") . 

Selection  of  hex  and  digitized  representations  -  The  new  package  allows 
the  user  to  "turn  on  or  off"  any  or  all  of  the  three  types  of  hex  road/river 
displays  and  then  allows  the  same  flexibility  with  the  digitized  displays. 
Similar  capability  existed  previously  but  not  as  flexibly.  In  both  cases  this 
capability  is  invaluable  as  an  assist  to  t.,e  user  allowing  display  of  only 
these  road  s/rivers  he's  interested  in  modifying. 

-Cc d/r i ver  generation  -  Previously  this  process  was  affected  by  using 
ccss-airs  to  identify  the  hexes  containing  the  newly  generated  rcad/river. 

*. r  f-:  new  package  this  p'Gcess  is  accomplished  by  using  the  graph  tablet  ana 
0  C  n  / ;  2  r  . 
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Army  Study  Documentation  and  Information  Retrieval  System  (ASDIRS) 

ANRAL-RS  | 

ATTN;  ASDIRS  j 

Room  1A518,  The  Pentagon  | 

Washington,  D.C.  20310  j 

i 

US  Army  TRADOC  Analysis  Command-WSMR  1  ! 

ATTN:  ATRC-WSL  (Technical  Library)  I 

White  Sands  Missile  Range,  NM  88002-5502  ’ 

US  Army  TRADOC  Analysis  Comma nd-FLVN  I 

ATTN;  ATRC-FT  (Technical  Info  Center) 

Fort  Leavenworth,  KS  66027-5200 

US  A^my  Combined  Arms  Research  Library  ( CA  .  1 

ATTN:  ATZL-SWS-L 

Fort  Leavenworth,  KS  66027-5000 


